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PARHIS PROGRAM 


1.0 SCOPE 

This document contains the description of the implementation of the PARHIS 
program. The purposes of the program are as follows: 

(1) To produce histograms of the greenness profile derived parameters 

2 

a, 6, t^ and x • Alpha is the approximate greenness rise time, Beta is 

the approximate greenness decay time, t is the spectral croo emergence 
2 ° 

date, and x pe<^ degree of freedom is the goodness of fit of the actual 
data to the computed greenness profile. 

(2) To produce statistical information concerning the a, 0, t^ and x“ 
parameters computed by the CLASFYG Program. 


1-1 


2.0 APPLICABLE DOCUMENTS 




The following documents form a part of this specification: 

AD 63-2457-3308-03 Transferring Badhwar Software. 

AD NAS 9-15200 Technical Memorandum Format Specifications for LACIE (Phase 
III) and Accuracy Assessment Computer Data Products. 



3.0 SYSTEM DESCRIPTION 


3.1 SYSTEM FLOWCHART 

The system level data flow diagram for the PARHIS Program is depicted in 
Figure 3.1.1. A program hierarchy is shown in Figure 3.1.2. 
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/CLASFY6> 
CLASSIFI- 
CATION 
\FILE > 



Figure 3.3.1 - System level flow diagram for the PARHIS program. 
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Figure 3.1.2 Hierarchy diagram for the PARHIS Program. 
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3.2 HARDWARE DESCRIPTION 


The software for the PARHIS Program 1s operational on the IBM ou31 computer 
at PURDUE. 
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3.3 SOFTWARE DESCRIPTION 


PARHIS was designed to produce histograms of the parameters u, £, t , and 

2 ° 

X computed by the CLASFY6 Program. Alpha is the approximate greenness rise 

time, Beta is the approximate decay time, t is the spectral crop emergence 
2 ° 

date and x degree of freedom Is the goodness of fit of the actual data 

to the computed greenness profile. Two sets of histograms are available to 

the user. If the user specifies a limit to be applied before updating the 

histograms, histograms will be produced for each of parameters and for the 

ground truth codes. These limits are input to the program via the rontrol 

0 

card file and pertain to a upper limit specified for the x' parameters, a 
lower limit for the t^ parameters, and a lower limit for the a parameters 
(See Section 3.4.3 for a complete description of the CUTS card). If no 
limits are specified histograms are produced for each parameter. For any 
given run, histograms can be obtained for up to three categories. A 
category can be a single ground truth class like "spring wheat", or a 
combination of ground truth classes like "small grains". Ground Truth 
codes are mapped to specific categories through a "ground truth transformation" 
table. (See Section 3.4.2 for a complete description of the ground truth 
transformation table). 

Ground truth data is used in the process of determining if a specific pixel 
value is among the categories chosen to be graphed. The program processes 
each pixel in the following manner; 

(1) The pixel is assigned to a majority category. This majority category 
is either the category of the first subpixel or is the category which 
occurs the most among the six sub-pixels categories. 

(2) The pixel's majority ground truth code value is saved for eventual 
output. 

(3) Through the use of the ground truth transformation table a transformed 
numeric code is assigned to each of the six ground truth sub-pixels 
which correspond to the g’vcn pixel. 
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(4) The number of occurance of the majority category is defined to be the 
purity of the given pixel. This purity is compared to a user 
specified pixel purity range, and if the number of occurances fall 
outside of this range then there is no further processing of this 
pixel . 

(5) If the majority category is greater than the number of categories 
specified by the user then there is no further processing of this pixel. 

(6) If the pixel value of the classification parameter a is zero then there 
is no further processing of the pixel. 

(7) If there are no limits specified the histograms are updated according 
to the classification parameter to reflect the occurance of an 
additional pixel. If limits are specified then each classification 
parameter must first pass the aj^plied limit test before the histograms 
are updated. 

(8) Statistical variables are updated. 

When each pixel has been processed the program computes statistical informa- 
tion for all pixels, and the histograms and statistical information are 
printed. 
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3.4 FILE DESCRIPTIONS 


3.4.1 INPUT FILE 

Two input data files are required to execute the PARHIS program. The two 
files and their descriptions are as follows: 

PARHIS accepts as input, a classification file output from the CLASFYG 

PROGRAM. This classification file consist of 118 records. The first record 

is a header record consisting of 3060 bytes. The header record follows 

universal format requirements. Records 2-118 contain data records. Each 

data record consists of 196 pixel vectors. Each pixel vector consists of 

2 

four parameters: a, 6, t^, and x • Each parameter contains a signed 

integer value stored in a 32 - bit full word. (For a complete description 
of this file see "As-Built" Design Specification for CLASFYG.) 

The Ground Truth file is in universal format with one channel per physical 
record. There are 351 records of length 540 8 bit-bytes. The contents of 
each byte have been biased with -128 and are stored in 8 bit twos-complement 
notation. (For a complete description of the file see Earth Resources Data 
Format Control Book, Volume 1, PH0-TR543). 
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3.4.2 USER DEFINED FILE <SYMBOL FILENAME> <SYMBOL FILETYPE> A 

This file is used to specify (1) the pixel purity range and (2) the ground 
truth transformations. 

The pixel purity range defines the acceptable pixel purity for any given 
execution of the PARHIS PROGRAM. (For a complete description of pixel purity 
See Section 3.3.) The ground truth transformation allows the user to map 
specific ground truth codes to "Classification Categories". These categories 
correspond to the numerical order of the categories entered on the CROP 
control card in the required control card file (See Section 3.4.3 for all 
exceptions concerning the use of this card). Therefore, any assignment of a 
crop code to a category greater than the total number of categories entered 
signifies that the code is of no interest. If a crop code is not assigned 
to a category the program assigns as a default a category of 6. The last 
entry in the symbol file must be 0 0 0. 

The first entry in the symbol file is as follows: 


Column 

1 

2 

3 


Format 

11 

IX 

11 : 

Purpose 


Start 


end 

Defines the start and end of a 
range of pixel purity. 

The remaining entries 

in 

the symbol file 

are as follows: 

Columns 

1-5 

6-10 

11-15 


Format 

15 

15 

15 : 

Purrose 


start 

’nd 

category : 

Defines the start and end of a range 
of crop values assigned to a 
category. 


0 

0 

0 

Signifies the end of Ground Truth 
transformation information. 
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The following is 
1 6 

an example of a symbol file 

1 

10 

1 

11 

20 

2 

21 

79 

3 

80 

80 

6 

84 

86 

2 

127 

127 

3 

164 

164 

6 

165 

165 

3 

0 

0 

0 
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3.4.3 USER DEFINED FILE <FILENAME> CC A 

This Control Card file is used to specify inputs to the PARPHIS program. 

The inputs are on card image records. Each record consists of (1) a keyword 
which is ten characters or less and begins in the first card column and (2) 
input parameters in columns 11 through 72. The following descriotion lists 
the keywords and describes the corresponding inputs. 


KEYWORD ACCEPTABLE INPUTS DESCRIPTION 


ALPHA RNG 


BETARGN 


T0RNG 


CROP 


CUTS 


Pair of positive numbers 


Pair of positive numbers 


Pair of positive numbers 


1-3 crop names 


3 positive numbers 


This card defines the minimum and 
maximum values to be plotted for the 
Alpha parameter. The numbers are 
assumed to be positive real numbers 
and any integers will be converted. 
The numbers are separated by any 
del imi ter except ' . ' . 

This card defines the minimum and 
maximum values to be plotted for the 
Beta parameter. The numbers are 
assumed to be positive real numbers 
and any integers will be converted. 
The numbers are separated by any 
del imi ter except ' . ' . 

This card defines the minimum and 
maximum values to be plotted for the 
t parameter. The numbers are 
assumed to be positive real numbers 
and any integers will be converted. 
The numbers are separated by any 
delimiter except ' . ' . 

This card gives names to the 
categories to be plotted. The 
categories are separated by any 
non character delimiter except for 
a blank. Embedded blanks are 
considered part of a categorie's 
name. 


This card defines limits to be 
applied when updating the histograms. 
The numbers are assumed to be oositive 
real numbers and any integers will be 


3-10 


KEYWROD 


ACCEPTABLE INPUTS 


DESCRIPTION 




converted. The numbers are 

separated by any delimiter except 
1 1 

• • 

AI 

Analyst's name 

This card specifies the analysts 
name for report identification and 
is an optional input. 

DATE 

Free form 

This card gives the date for report 
identification and is an optional 
input. 

SEGMENT 

Segment number 

This card specifies the segment 
number for report identification 
and is an optional input. 

*END 

Ignored 

This card identifies the end of the 
user defined cards. 


The following is an example of a user's CONTROL CARD file with limits specified 


AI 

DATE 

SEGMENT 

ALPHARNG 

BETARNG 

T0RN6 

CROP 

CUTS 

*END 


MARY TOMPKINS 
APRIL 8, 1981 
0123 

0.0 4000.0 
0.0 3600.0 
1000.0 2000.0 
CORN, SOYBEAN. OTHERS 
400.0 1280.0 0-0 


The following is an example of a user's CONTROL CARD file without limits: 


AI 

MARY TOMPKINS 

DATE 

APRIL 8, 1981 

SEGMENT 

0123 

ALPHARNG 

0.0 4000.0 

BETARNG 

0.0 3600.0 

TORNG 

1000.0 2000.0 

CROP 

CORN, SOYBEAN, OTHERS 

♦END 
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3.5.1 PROGRAM PA RH IS 


Purpose 

(1) To produce histograms of the greenness profile derived parameters a, 

2 

6, t^% and x • Alpha is the approximate greenness nse time, Beta is 

the approximate decay time, t is the spectral croo emergence date, 

2 ° 

and X per degree of freedom is the goodness of fit of the actual data 
to the computed greenness profile. 

2 

(2) To produce statistical information concerning the a, S, t^t and x 
parameters computed by the CLASFYG Program. 

Li nkaqes 

PARHIS calls PHISIN, HISTOS, JULIAN, and CROPP. 

Interface 
Calling sequence: 

Not applicable (an example of an EXEC to execute PARHIS can be located 
in Section 4.0.) 


Calling sequence parameters: 
Not appl icable. 


Function value: 

Not applicable. 


Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 


Element 


Label 

Variable 

Position 

/NSBIXL/ 

NSUBPX(6) 

1 

/DEFGT/ 

GTRSEG 

1 


Input/ 

Output Description 

0 Six subpixel that 

map to a pixel. 

0 Ground Truth segment 

number. 
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Element Input/ 


Label 

Variable 

Posi tion 

Output 

Descri ption 


TYR 

2 

0 

Year ground truth 
tape produced 
(thi'^ version.) 


GTDATE(3) 

3 

0 

Julian date ground 
truth tape produced 
(this version.) 

/DEFKL/ 

KLSEG 

1 

C 

Landsat segment 
classi tied. 


KYR 

2 


Year classification 
tape proouced. 


KLDATE(3) 

3 

0 

Jul ian date 
classification tape 
produced. 

/RHT/ 

RCR0P(4,3) 

1 

0 

Crop classes . 


RCUT{3) 

2 

0 

Li mi ts for a, S, 
and t^ parameters. 


ICUT 

3 

0 

Flag; 1 - indicates 
present of parameter 
cuts . 


Blank COMMON parameters: 
None. 


Inputs 


Unit 

Im. 

Description 

9 

Seq, data 

Ground truth file (See Section 3.4.1). 

10 

Seq. data 

Classification file (See Section 3.4.1). 

19 

Seq. data 

Symbolic mapping elements, pixel purity range 
(See Section 3.4.2) , 

Ouputs 

Unit 

Type 

Description 

5 

Terminal 

Run time descriptions. 

6 

Printer, disk 

Plot report. 
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Storage requirement 
Not applicable. 


Descri ption 

Ground truth data is used In the process of determines if a specific pixel 
value is among the categories chosen to be graphed. The program processes 
each pixel in the following mariner: 

(1) The pixel is assigned to a majority category. This majority category 
is either the category of the first subpixel or is the category 
which occurs the most among the six sub-pixels categories. 

(?.) The majority pixel's ground truth code value is saved for eventual 
output. 

(3) Through the use of the ground truth transformation table a transformed 

numeric code is assigned to each of the six ground truth sub-pixels 

which correspond to the given pixel. 

(4) The number of occurance of the majority category is defined to be the 

purity of the given pixel. This purity is compared to a user specified 
pixel purity range, and if the number of occurances fall outside of 
this range then there is no further processing of this pixel. 

(5) If the majority category is greater than the number of categories 

specified by the user then there is no further processing of this 
pixel . 

(6) If the pixel value of the classification parameter a is zero then 
there is no further processing of this pixel. 

(7) If there are no limits specified the histograms are updated according 
to the classification parameter to reflect the occurance of an 
additional pixel. If limits are specified then each classification 
parameter must first pass the applied limit test before the histograms 
are updated. 

(8) Statistical variables are updated. 
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When each pixel has been processed the program computes statistical 
information for all pixels, and the histograms and statistical information 
are printed. 

Listing 

See Appendix B for program listing. 
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3.5.2 SUBROUTINE APLOTS 
Purpose 

To output histograms and statistical information. 

Li tiKaqes 

APLOTS is called by HISTOS. 

Interface 
Calling sequence: 

CALL (NBIN, AML, DM, XMOM, AR, FIT, NFIT, NUNDR, NOVER, NPLOT) 
Calling sequence parameters: 


Input/ 


Argument 

Output 

Description 

NBIN 

I 

Number of Bins . 

AML 

I 

Lower edge of the histogram. 

DM 

I 

Bin width. 

XMOM 

I 

Vector to be plotted. 

AR 

I 

Square root of ER (ERROR). 

FIT 

I 

One dimension of vectors. 

NFIT 

I 

Number of curves to be plotted. 

NUNDR 

I 

Number under the lower limit of histograms 

NOVER 

I 

Number over the upper limit of histograms. 

NPLOT 

I 

Number of the plot. 

Function value: 




Not applicable. 
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Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 

Element Input/ 


Label 

Variable 

Posi tion 

Output 

Description 

/RHT/ 

RCROP 

1 

I 

Name of input crops. 


RCUT 

2 

I 

Limits for Alpha, t 
and CHI square. 


I CUT 

3^ 

I 

Flag;for cut card, 

1 = card parameters. 

/DEFGT/ 

GTRSEG 

1 

I 

Ground truth segment 
number. 


TYR 

2 

I 

Year for GTRSEG. 


GTDATE 

3 

I 

Julian date for GTRSEG 

/DEFKL/ 

KLASEG 

1 

I 

Classification file 
segment number. 


KYR 

2 

I 

Year for KLASEG. 


KLDATE 

3 

I 

Julian date for KLASEG 


Blank COMMON parameters: 
None . 




Type Description 

Report Histograms and statistical information. 


Storage requirement 


Not applicable. 
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Description 

APLOTS updates vectors for plotting. It calculates statistical information 
which includes means, SIGMA values and errors of the vectors. It generates 
12 histograms for Alpha, Beta, t^ and CHI-square on each crop, if there is 
no cuts card. Otherwise, it outputs 14 histograms including Alpha, Beta, 
t^ and CHI-square on each crop and ground truth code. 

FI owchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.J SUBROUTINE BIN 


Purpose 

To check that the coefficients are within the range of lower and upper limits. 


Linkages 

BIN is called by HISTOS. 

Interface 

Calling sequence; 

CALL (X, XMIN, DX, NBIN, IVEC) 

Calling sequence paraineters: 


Input/ 


Argument 

Output 

Description 

X 

I 

Coefficient for the plot. 

XMIN 

I 

Minimum range of the coefficient 

DX 

I 

Width of the range (bin width). 

NBIN 

I 

Number of BINS. 

IVEC 

I 

Number of histogram to update. 

Function value: 




Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters: 

None. 
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Inputs 

?ione. 


Outputs 

None. 

Storage requiremen t 
Not applicable. 

Description 

BIN tests and returns if the coefficient value lies outside a defined limit; 
else, BIN updates the pixel count to reflect a coefficient's occurence. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.4 SUBROUTINE CROPP 


Purpose 

CROPP accepts six subpixels as input and outputs a pixel value representative 
of the subpixels. 

Linkages 

CROPP is called by PARHIS. 

Interface 

Calling sequence: 

CALL CROPP (KROP, IXLCNT) 

Calling sequence parameters: 

Input/ 

Argument Output D^iscription 

KROP 0 Majority crop code. 

IXLCNT 0 Count of number subpixels that match the 

majority code. 

Function value: 

Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 




El ement 

Input/ 


Label 

Variable 

Posi tion 

Output 

Descri ption 

/NSBIXL/ 

NSUBPX(6) 

1 

I 

Subpixels that map to 
a pixel . 


Blank COMMON parameters: 
None. 



Inputs 

None. 


Outputs 

None. 

Storage requirement 
Not applicable. 

Description 

The first sub-pixel value upon entry is considered to be the majority pixel 
(KROP) value. The NSUBPX array is traversed and the number of codes equal 
to KROP counted. This procedure continues until a count of each unique 
code is made. If at anytime a count becomes greater than the count of KROP 
this code becomes KROP's value. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.5 SUBROUTINE HISTOS 


Purpose 

HISTOS sets plots=0, on the first call. It calls subroutines to update 
histograms and counters. 

Linkages 

HISTOS is called by PARHIS. 

HISTOS calls APLOTS and BIN. 


Interface 
Calling sequence: 

CALL (IHIS, XLOW, NBIN, XHIGH, X, SCALE) 


Calling sequence parameters: 
Input/ 

Argument Output 


IHIS I 

XLOW I 

NBIN I 

XHIGH I 

X I 

SCALE I 


Description 
Number of histogram. 

Lower limit of histogram. 

The number of BINS. 

Upper limit of histogram. 

The variable vector of the histogram. 
The weight of the scale factors. 


Function value: 

Not appl icable. 


Labeled COMMON parameters: 
None. 


Blank COMMON parameters: 
None. 
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Inputs 


None. 

Outputs 

Unit Type Description 

5 Terminal Error MSG for number of histogram >50. 

Storage requirement 
Not applicable. 

Description 

HISTOS zeros the plot arrays on the first call, then checks the number of 
histograms. If the number of histograms is greater than or equal to 50, 
it outputs an error message. Otherwise, HISTOS updates the histograms and 
counters by calling APLOTS to output the histograms and bin to update the 
vector. 

FI cwchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.6 FUNCTION ICE 


Purpose 

To established the integer character equivalence of a byte. 

Linkages 

ICE is called by APLOTS, PHISIN. 

Interface 

Calling sequence: 

K = ICE (INT) 

Calling sequence parameters: 

Input/ 

Argument Output Description 

INT I One byte in character form. 

Function value: 

Name Description 

K One byte in computation form. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters : 

None. 

Inputs 
No ne. 


Outputs 

None, 
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storage requirement 
Not applicable. 

Descri ption 

ICE sets the input parameter to the function and returns. 

FI owe hart 
Not applicable. 

L isting 

See Appendix B for function listing. 
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3.5.7 FUNCTION I VALUE 


Purpose 

To allow the In-line storage and testing of integer quoted literals. 

Li nkages 

IVALUE is called by PHISIN. 

Interface 

Calling sequence; 

K = IVALUE (INT) 

Calling sequence parameters: 

Input/ 

Argument Output Description 

INT I Quoted literal declared integer. 

Function value: 

Name Descri ption 

K Quoted literal. 

Labeled COMMON parameters; 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 

Blank COMMON parameters; 

Ncne . 

Inputs 

None. 

Outputs 

None. 
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storage requirement 
Not applicable. 

Descrl ption 

IVALUE sets quoted literals to integer function and returns. 

FI owe hart 
Not applicable. 

Listing 

See Appendix B for function listing. 
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3.5.8 SUBROUTINE JULIAN 
Purpose 

To convert a Gregorian Calendar date to a Julian calendar date. 
Linkaqej 

JULIAN is called by PARHIS. 

I nterface 
Calling sequence: 

CALL JULIAN (JPATE, INERR, INDAY, INMNTH, INYEAR) 


Calling sequence parameters: 
Input/ 

Argument Output 
JDATE(3) 0 

INERR 0 

INDAY I 

INMNTH I 

INYEAR I 


Description 

Array to return Julian date. 

Error flag Indicating input value out of range 
(zero returned if no error occurred). 

Day of month . 

Month of the year. 

Last two digits of the year. 


Function value: 

Not applicable. 


Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 
None. 


Blank COMMON parameters: 
None. 


Inputs 

None. 
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Outputs 

None. 

Storage requirement 
Not applicable. 

Description 

If the input day is less than 1 or greater than 31, and input month 
than 1 or greater than 12 set INERR = 1 for error flag and return. 
Julian date from month and day. If the year is a Leap year and the 
is greater than two add one to the computed Julian date. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 


is less 
Compute 
month 
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3.5.9 SUBROUTINE PHISIN 


Purpose 


Reads, classifies, and analyzes cards describing the following: 


AI, SEGMENT, DATE, FILE 

ALPHARNG 

BETARNG 

TORNG 

CUTS 

CROP 

*END 


DOCUMENTATION - READ AND WRITTEN. 

MIN MAX RANGE FOR ALPHA COEFS. 

MIN MAX RANGE FOR BETA COEFS. 

MIN MAX RANGE FOR TO COEFS. 

LOWER LIMIT FOR PARAMETER a, UPPER LIMIT FOR 
t AND PARAMETERS g. 

]-3 CROPS TO MAP. EMBEDDED BLANKS 
ARE INCLUDED IN NAME. 

SPECIFIES THE END OF USER DEFINED CARDS. 


Li nkages 

PPLTIN is called by PARHIS. 

Interface 
Calling sequence: 

CALL PPLTIN (NCROP, RCROP, RANGE, CUTS, lERR) 


Calling sequence parameters: 


Argument 

Input/ 
Ou tput 

Descri ption 

NCROP 

0 

Total number of user input crops. 

RCROP 

0 

Crops to be evaluated. 

RANGE 

0 

Minimum maximum of Alpha, Beta, and t^ 

CUTS 

0 

Limits for Alpha, Beta, and t^. 

lERR 

0 

Error flag 

Function value: 

Not applicable. 

0 = OK 

1 = error 
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Labeled COMMON parameters: 

Full description of labeled CONWON blocks are contained in Appendix A. 
None. 


Blank COMMON parameters: 
None. 


Inputs 

Unit Type Description 

21 Seq. data User defined control card file (See Section 3.4.3). 


Outputs 

Unit Type 

20 Printer 

5 Terminal 


Descri ption 

Control card input for report. 
Run time errors. 


Storage requirement 
Not appl icable . 


Description 

PPLTIN processes each input card. After the *END card is reached PPLTIN 
test for the following conditions: 

1. MORE/LESS THAN TWO NUMBERS ON THE ALPHA, BETA, T0 RANGE CARDS. 

2. MIN>= MAX ON THE ALPHA, BETA, TO RANGE CARDS. 

3. ALPHA, BETA, TO RANGE CARD MISSING. 

4. MORE THAN THREE CROPS ON A CROP CAPO. 

5. CROP CARD MISSING. 

6. CUTS CARD PRESENT BUT ONE OR MORE VALUES. 

7. MORE THAN THREE NUMBERS ON CUTS CARD. 

If any of the conditions exist a diagnostic message is issued and I ERR is 
set equal to one. If a control card is not recognized a warning message is 
printed. 
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FI owchart 


Not applicable. 

Li s ti nq 

See Appendix B for routine listing. 
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4.0 OPERATION 


4.1 OPERATING DESCRIPTION 

PARHIS is operational on tha IBM 3031 computer at LARS, West Lafayette, 
Indiana . 

The PARHIS program is one of the programs of the BADHWAR SYSTEM which 
includes the programs CLASFYT, CLASFYG, MISMAP, PARPLT, PARHIS, and PARCLA. 

PARHIS requires the user of a D disk which is assigned as a temporary disk 
and an E disk upon which is used to load LARS routines. The user, therefore, 
must not assign a disk to his machine using either MODE E or MODE D. These 
disks, will be assigned as needed. 

Prior to executing the PARHIS program the user must (1) establish on his A 
disk a SYMBOL file as described in Section 3.4.2 and (2) establish the 
CWTROL CARD file as described in Section 3.4.3, if he wishes to use this 


4.2 COMMANDS DESCRIPTION 


To execute PARHIS, the user enters a series of conmands which invoke the JOB 
CONTROL SOFTWARE. These commands are divided into two classes namely (1) 
FUNCTION commands and (2) PROGRAM commands. The FUNCTION commands, which 
perform all the functions except executing the program are reusable; i.e., 
once they are invoked they remain in effect until reentered. The PROGRAM 
commands, which execute the program, must be reentered each time the program 
is to be executed. 

The following list gives the commands required to execute the PARHIS program. 
They are all FUNCTION commands except the PROGRAM command PARHIS. These 
conmands must be given in the listed order except that the order of the 
DEFGTRU command and the DEFCLAS command may be interchanged. 

START 

DEFGTRU 

DEFCLAS 

PARHIS 

END 

The following sections describe each of the commanos in detail. Input fields 
are separated by blanks. If more than one word is required to describe an 
input field, the descriptive text is enclosed in pointed brackets <>. If 
an input is optional the field is inclosed in square brackets []. Do not 
include these explanatory characters <> [] when actually submitting input to 
the computer. To enter a command the user types one input per defined input 
field and separates each field with a blank. 
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4.2.1 START 


The START coimand spools the user's console file. The use of this command, 
along with the END command, will provide a listing of all infonrtation 
appearing on the user's console file. (If running an interactive job, this 
is the terminal; if running a batch job this is a system defined device.) 
The START command is invoked by the user typing the following: 

START 


4.2.2 DEFGTRU 

The DEFGTRU command defines a Ground Truth file. The user can use this 
corrmand to define Ground Truth files on tape, disk, or may request the use 
Of a file from the LARS RT&E Data Base. If the data request is for the 
use of a file from the LARS Data Base a series of programs are invoked to 
provide interface with the data base. The following diagram illustrates 
this software flow. 

..RTEERR (LARS ROUTINE) 

DEFGTRU GTRUINF.... 

..GTINFO (LARS ROUTINE) 

For a detailed description of the above JOB CONTROL SOFTWARE See Appendix B. 

The DEFGTRU command has the following forms and is invoked by typing one 
of the following, according to the user's requirement. 

If the file is on tape - 

DEFGTRU TAPE# FILE# < TAPE DENSITY > 

If the file is on disk - 

DEFGTRU FILENAME FILETYPE FILEMODE 
If the file is on the LARS Data Base - 

DEFGTRU SEGMENT# YEAR 

(year-last two digits of data generation year) 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and does not have to be reissued unless the user wishes 
to redefine the input Ground Truth File. 
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4.2.3 DEFCLAS 


The DEFCLAS conmand defines the input Classification file. The user can 
use this command to define a Classification file on tape or disk. The 
DEFCLAS cormiand has the following forms and is invoked by typing one of the 
following, according to the user's requirement. 

If the file is on tape - 

DEFCLAS TAPE# FILE# < TAPE DENSITY > 

If the file is on disk - 

DEFCLAS FILENAME FILETYPE FILEMODE 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and does not have to be reissued unless the user wishes 
to redefine the input Classification File. 


4-5 


4.2.4 PARHIS 

The PARHIS command is a PROGRAM command and is used to invoke the execution 
of the PARHIS program. This command must not be used unless the DEFCLAS 
and the DEFGRTU FUNCTION commands have been previously issued. Also, as 
previously stated the user must have established a SYMBOL FILE and CONTROL 
CARD FILE on his A disk before invoking this command. The PARHIS command 
is invoked by the user typing the following: 

PARHIS < SYMBOL FILENAME > < SYMBOL FILETYPE > < CONTROL CARD FILENAME > 

The output from the PARHIS program is spooled to the HOUSTON line printer. 
The output consists of HISTOGRAMS and the USER INFORMATION file. 
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4.2.5 END 


Ttiis command closes the user's console file and causes a spooled copy to be 
sent to the HOUSTON printer. This command has no effect if the START 
command was not previously issued. The END command is invoked by the user 
typing the following. 

END 
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4.3 OPERATING EXAMPLE 


For our example we will assume the following: 

The symbol file is established on the user's A disk under the file description 
PARHISl DATA A. 


The control card file is established on the user's A disk under the file 
description: PARHISl CC A. 

The user has two different Classification files which he wishes to input to 
the PARHIS PROGRAM. He will therefore, issue two PROGRAM commands in his 
command sequence. 

Furthermore, the user has elected to use a ground truth file at LARS. 

COMMAND EXPLANATION OR ACTION TAKEN 


START 

DEFGTRU 882 79 
DEFCLAS 088279 079 B 


PARHIS PARHISl DATA PARHISl 
DEFCLAS 2345 23 1600 

f 

PARHIS PARHISl DATA PARHISl 


END 


Spools the console file. 

Defines a ground truth file using 
data from the LARS Data Base. 

Defines a class file on the users 
B disk. This data is on a disk which 
the user has previously attached to 
his disk using a B mode. 

Executes the PARHIS PROGRAM. 

Redefines the class file. This file 
is from a 1600 BPI tape. 

Executes the PARHIS PROGRAM. The user 
has chosen to define his symbol file 
and CC file the same as in the previous 
execution of PARHIS. 

Closes the user's console file and spools 
the files to the HOUSTON printer. 
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APPENDl,' A 
COMMON Blocks 


COMMON BLOCKS 


/NSBIXL/ NSUBPX(6) 

NSUBPX Six subpixels that map to a pixel. 

/DEPOT/ GTRSEG, TYR, GTDATE(3) 

GTRSEG Ground truth segment number. 

TYR Year of ground truth file creation. 

GTDATE Julian date of ground truth file creation. 

/DEFKL/ KLASEG, KYR, KLDATE 

KLASEG Classification segment number. 

KYR Year of classification file creation. 

KLDATE Julian date of classification creation. 

/RHT/ RCROP, RCUT, I CUT 
RCROP Names of crops input. 

RCUT a, 3 t limits applied to graph output when the cut option is 

used. ° 

ICUT A flag which is equal to zero if the cuts option is not used and 

one when the cuts option is used. 
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